home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 80 / CD Actual 80 Julio-Agosto 2003.iso / Linux / LinuxGazette / lg / issue91 / misc / mathew / code / pvclnotes.txt < prev    next >
Encoding:
Text File  |  2003-05-20  |  3.8 KB  |  127 lines
  1. *This is the Pixel View Combo Plus Video For Linux Driver (V4L1) README.
  2.  
  3. *Introduction
  4.  
  5. Hello There!!!
  6. If you're interested in trying out this device driver, you're either
  7. really very brave, or very desperate or both. This is the first
  8. release of this driver, which I intend to Maintain and support
  9. because, and only because the only other platform on which this card
  10. is supported, is Windows 98. That smacks hard on my ego.........
  11.  
  12. *Disclaimer
  13.  
  14. This device driver is based on highly experimental and untested
  15. code. If you're trying it out, you should be either of:
  16.  
  17. - Kernel Hacker.
  18. - Alpha Tester.
  19. - Desperate(ly) Poor Linux fanatic. (Uh, I can't afford a new card...)
  20. - Reckless Daredevil.
  21.  
  22. Please - no email asking me to replace your burnt out combo tv card.
  23.  
  24. *Features
  25.  
  26. - Works with xawtv version 3.72 (at least that's all I've tested it on.)
  27. with the XFree4 Xserver release in the following graphics modes:
  28. 800x600, 640x480 @ 24bpp, 16bpp in all combinations.
  29.  
  30. Note: Please do not try 8-bit depth at any resolution. The driver does not
  31. object, but the result is not very pleasant (to your opinion about my
  32. programming skills ;-) ).
  33.  
  34. - Support for PAL (B,G,H,I) (50Hz) broadcasts. 
  35. Note: Only Framebuffer Overlay is supported at present. ie; you can
  36. just watch tv. No video capture.
  37.  
  38. - Modular code - can be easily extended to other cards of this family.
  39.  
  40. - Patch available against kernel version 2.5.47 and 2.4.18.
  41.   See: http://cherry.freeshell.org/downloads/
  42.  
  43.  
  44. *Bugs
  45.  
  46. - Freezes, I repeat, FREEZES the machine if you switch consoles while
  47. xawtv is running. It's ok to switch consoles even if the driver is
  48. loaded if xawtv is not running.
  49.  
  50. - At 800x600 resolution, the graphics buffer gets written over. The
  51. result is more of an eyesore rather than any serious harm. Fullscreen video
  52. works fine in all the supported (see above) video modes.
  53.  
  54.  
  55. *TODO
  56. - Fix the console switch bug.
  57. - Implement Dynamic Capture buffer resizing, to prevent messing up the screen
  58.   at higher resolutions.
  59. - Implement Chromakeying.
  60. - Implement Brightness, Contrast, Hue and Colour controls.
  61. - Implement Audio IOCTLs.
  62. - Implement Video grabbing etc.
  63. - Implement V4L2.
  64.  
  65. *File List
  66. All paths are w.r.t the linux source tree root.
  67. drivers/media/video/pvcl.c
  68. drivers/media/video/pvcl.h
  69. drivers/media/video/pvcard.h
  70. drivers/media/video/pvproc.h
  71. drivers/media/video/vpx322xd.c
  72. Documentation/video4linux/pvclnotes.txt
  73.  
  74. Configuration entry in drivers/media/video/Kconfig
  75. Configuration entry in drivers/media/video/Makefile
  76.  
  77. *Configuration
  78.  
  79. -Patch the kernel as described in the kernel README file or the
  80. Kernel-HOWTO document.
  81. -While configuring the kernel, Enable the following options:
  82.  1. "Prompt for development and/or incomplete code/drivers"
  83.  2. "I2C Support" in the Character Devices Section.
  84.  3. "I2C bit-banging interfaces" in the I2C Support Section.
  85.  4. "Video For Linux" in the Multimedia Devices Section.
  86.  5. "Pixel View Combo Tv Plus (V4L1 Driver) (EXPERIMENTAL)"
  87.  
  88.  
  89. *Installation
  90.  
  91. -compile the driver using 'make modules' and 'make modules_install'.
  92.  
  93. -do 'modprobe vpx322xd'
  94.     You should see something like:
  95.  
  96.     i2c-core.o: i2c core module version 2.6.4 (20020719)
  97.     vpx version 0.1 (November, 2002)
  98.  
  99. -do 'modprobe pvcl'
  100.     You should see something like:
  101.  
  102.     Linux video capture interface: v1.00
  103.     i2c-algo-bit.o: i2c bit algorithm module version 2.6.4 (20020719)
  104.     pvcl: registered device video
  105.     pvcl: Found Cirrus Logic GD 5446
  106.     pvcl: Detected 2MB video ram.
  107.     vpx: probing i2c adapter clgd54xx ... 
  108.     vpx: Found: vpx 3225d chip @ 0x86 
  109.  
  110. -do 'modprobe tuner type=24'
  111.     You should see something like:
  112.  
  113.     tuner: probing clgd54xx i2c adapter [id=0x10005]
  114.     tuner: chip found @ 0xc6
  115.  
  116. -Now switch back to the xserver and run xawtv.
  117.  
  118. Happy Hacking!!
  119.  
  120. Cherry.
  121.  
  122. "Cherry George Mathew" <cherry@freeshell.org>
  123. http://cherry.freeshell.org/
  124.  
  125. PS: Please send your comments/patches to video4linux-list@redhat.com
  126. and send me a cc:
  127.